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Designing for a Managed 
Memory World 
+ After successfully completing this lesson, you 
will be able to: 
+ Understand the effect garbage collection 
has on library design 


+ Effectively design classes for this 
environment 


Garbage Collection 


+ How does it affect API design? 
« Of course, no leaks or stray pointers 
«No memory ownership issues 
+ Enables functional programming model 


Garbage Collection (2) 


+ Local vs. global view 


+ Possible to build faster domain-specific 
memory and resource management, but 
gains are lost in compound solutions 


+ For example, no common string type 
+ Issue: Non-deterministic lifetimes 


Resource Management 


. The garbage collector (GC) does an excellent 
job managing “managed” memory 


+ GC doesn’t manage external resources 
(database connections, Hnds, etc.) 


+» Generational mark-and-sweep garbage 
collection means non-deterministic finalization 


+ Exact time of finalization is unspecified 
+ Order of finalization is unspecified 
+ Thread is unspecified 


Resource Management (2) 


+ If you are encapsulating external resources: 


. Add a finalizer (C# destructor) to guarantee 
the resource will eventually be freed 


+ Provide developers an explicit way to free 
external resources 
+ Formalized in the [Disposable interface: 
+ Signals to users they need to explicitly 
Dispose of instances 
«Enables C# using support 
A 
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Destructors 


Object Finalize is not accessible in C# 
VERY different than C++ destructors 


public class Resource 
{ 
rResourceO { public class Resource 
{ 
protected override void FinalizeO { 
try { 


2 
finally { 
base.FinalizeO; 


Destructors (2) 


+ Only implement Finalize on objects that need 
finalization 
+ Finalization is only appropriate for clean up 
of unmanaged resources 
+ Keeps objects alive an order of magnitude 
longer 
+ Free any external resources you own in your 
Finalize method 
+ Do not throw exceptions in finalizers 
. The rest of your finalizer will not run 
a 
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Destructors (3) 


+ Do not block or wait in finalizers 


- All finalization for that process could 
be stopped 
+ Only release resources that are held 
onto by this object, and finalizer should 
not reference any other objects 


+ Will be called on one or more different 
threads 
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Dispose Pattern 


« Implement the dispose pattern whenever you 
have a finalizer 


+ Gives developers explicit control 


+ Free any disposable resources your type owns 
in the Dispose () method 


+ Not just the external resources 


« Propagate calls to Dispose () through 
containment hierarchies 


Dispose Pattern (2) 


+ Suppress finalization once Dispose () has 
been called 


- Dispose () should be callable multiple times 

without throwing an exception 

« The method will do nothing after the first call 

.« After Dispose) is called other methods on 
the class can throw ObjectDisposedException 
or you can re-create the internal state of the 
class on the fly 

a 
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Dispose Pattern (3) 


= Do not assume that Dispose() will be called 
- For unmanaged clean up, have a finalizer as well 


= Provide a Close () that calls Dispose () method if 
‘close’ is a preferred term for your type 

- Do call your base class’s Dispose () method if it 
implements IDisposable 


= Throw an ObjectDi sposedExceptionon 
Operations of a disposed type 


= On-demand re-creation is doable, but complex 


- Implement the dispose pattern on base types that 
commonly have subtypes that hold onto resources 
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public class Resource: IDisposable { 


} 


private boo1 disposed = false; 

pubic int Getvalue () { 
if (disposed) throw new objectDisposedException ()3 
ff do work 


public void Dispose () { 
Dispose(true); 
6C.SuppressFinalize (this); 


protected virtual void Dispose (bool disposing) { 
if (disposing) { 
f/f Dispose dependent objects 
disposed = true; 


/f Free unmanaged resources 
} 
~Resource() { 

Dispose(false); 
} 


Using Statement 
Acquire, execute, release pattern 
Works with any Disposable object 


+ Data acoess classes, streams, text readers 
and writers, network classes, etc. 


using (Resource res = new Resource O) 


res.DoWork O; 
} Resource res = new Resource(...); 


try { 
res.DoWork O; 
} 
finally £ 
if Cres != null) 
((IDisposabledres).DisposeO ; 


. Can 


1 find the “bug” in this 


yy 


ream output 
new b 


db, 0, b.Length)) != 0) £ 


static void Copy(string sourceName, string destName) { 
Stream input = File.OpenRead(sourceName) ; 
try © 
Stream output = File.Create (destName) ; 
try { 
byte[] b = new byte[65536]; 
int n; 
while Cn = input.Readtb, 0, b.Length)) != 0) £ 
output.Write(b, 0, n); 


H 

finally £ 
output.Close O; 

H 


} 
finally { 


input.CloseO; 


} 


ith using 
vent 


uld implement IDis 
of this support 


sable to take advantage 


» Provide a well-known named method that maps to 
privately implement Dispose method if appropriate 


d ing sourceNam destNam 


Resource Management 
“Whidbey Feature”: MemoryPressure 


+ GC.AddMemoryPressure (int pressure ) 

« Useful when you have a disproportionate ratio 
of managed-to-unmanaged resources 

+ Garbage collection (GC) alters its strategy, to 
increase the number of collections performed 

+ GC.RemoveMemoryPressure when your object is 
freed, to allow the GC to return to its standard 
strategy 


À 
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path) { 
new FileInfoG 


Resource Management 
“Whidbey” Feature: HandleCollector 


+ HandleCollector keeps track of a limited number of handles 

« Typically, unmanaged resource handles: HDCs, Hinds, etc, 
+ When you allocate a new handle, call Add 
« When you are freeing, call Remove 


+ As you add to the collector, it may perform a GC.Collect, to free existing 
handles, based on the current count and the number of resources available 


name: Allows you to track each handle type separately, if needed 


iniiafTAresholot The point at which collections should begin being 
performed 


maximumThresholes The point at which collections MUST be 
performed—this should be set to the maximum number of available 
handles 
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readonly HandleCollector GdiHandleType = 
new HandlecoTle 


atic IntPtr 


return temp 


} 


internal sta 
Deleteobject Imp] handl 
GdiHandleTyp e 


Exercise: What's Wrong with This 


public class File : IDisposable { 
private IntPtr fileHandle; 


public File(string path) { 
fileHandle = OpenFile (path); 
1 


public void Dispose () { 
CloseFile (fileHandle); 
1 
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Exercise: What's Wrong with This 


public class NetworkCache : Disposable { 
private File localFile; 
private IntPtr socketHandle; 


public NetworkCache (string tapPath, 
string url) £ 
localFile = new File (tapPath); 
socketHandle = OpenSocket Gurl); 


public void Dispose O £ 
local File.DisposeO ; 
CloseSocket (socke tHandle) ; 

3 

-NetmorkCache O £ 
local File.DisposeO ; 
CloseSocket (socke tHandle) ; 


} a 
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Lesson 7 Summary 


+ GC does a great job at handling managed 
memory 
+ Not designed for other resources 

+ Use Finalizers and the dispose pattern to manage 
external resources 

+ Finalizers—free resources you own 

+ Dispose—propagate through the containment 
hierarchy 

+ Take advantage of the using statement 
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